home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / arcers / av412.zip / AV.DOC next >
Text File  |  1994-12-14  |  10KB  |  222 lines
  1. AV.DOC
  2. 12/14/94
  3.  
  4. The AV.EXE program shows a directory of one or more archive files (ZIP, ZOO,
  5. etc), including some self-extracting files.  Features of this program:
  6.  
  7.   * The directory information is presented in full-screen mode and you can
  8.     use PgUp and PgDn to scroll amount the screens
  9.   * Allows you to sort the display of the members in a number of ways
  10.   * Allows you to reset the file date of the archive to match the date of
  11.     the most recent member of the archive
  12.  
  13.  
  14. A typical display might look (in part) like the following:
  15.  
  16. DEMOS411.ZIP      Date      Time OrigSize Method    NowSize  %reduce  1 of 1
  17. ------------  --------  -------- -------- -------- --------  -------
  18. DEMO.DOC      94/07/17  18:40:18     5185 Deflated     1945    63    [PgUp]
  19. DEMODEMO.CTL  94/06/20  22:27:10    48901 Deflated    14343    71    [PgDn]
  20. DEMOMAKE.EXE  94/10/12  20:28:36   232524 Deflated   138029    41    [Home]
  21. DEMOSCRS.DOC  94/07/17  18:33:34     4306 Deflated     1911    56    [End]
  22. DEMOSCRS.EXE  94/06/21  16:55:40    46371 Deflated    31033    34    [Up]
  23. DEMOSCRX.DOC  94/06/20  22:27:40     5023 Deflated     2106    59    [Down]
  24. DEMOSCRX.EXE  94/10/20  01:12:52    59294 Deflated    41653    30    [Sort]
  25. DEMOSYS.DOC   94/07/17  18:44:48   118061 Deflated    35136    71      [Name]
  26. DEMOSYS.REF   94/07/17  18:44:58   135181 Deflated    37751    73      [Ext]
  27. FILE_ID.DIZ   93/01/31  12:50:50      180 Deflated      157    13      [Date]
  28. SAMPLES.EXE   93/06/26  01:06:14     7005 Deflated     6738     4      [Size]
  29. START.BAT     93/07/31  00:00:52      375 Deflated      241    36      [CurSize]
  30. SUPER.F16     93/04/12  18:24:46     4096 Deflated     1330    68      [Ratio]
  31. TSHOW.EXE     92/02/06  20:45:02    33362 Deflated    17078    49      [Orig]
  32. VGA-ROM.F16   93/04/12  18:24:46     4096 Deflated     1354    67      [-Flip]
  33. WAYNESOF.GIF  93/01/30  20:47:00     9262 Stored       9262     0    [Esc]
  34.                                                                      [Quit]
  35.  
  36.                                                                      [Date]
  37.  
  38. ============  ========  ======== ======== ======== ========  =======
  39.  *16          94/10/20  01:12:52   713222            340067    53%
  40. DEMOS411.ZIP  94/10/21  02:04:32   341653
  41.  
  42.  
  43.  
  44. When viewing a screen's worth of information, you can typically choose among
  45. a number of options including the following:
  46.  
  47.         PgUp    view the previous screen's worth
  48.         PgDn    view the next screen's worth
  49.         Home    top line
  50.         End     bottom line
  51.         Up      move the screen up one line
  52.         Down    move the screen down one line
  53.         Sort    change the sort order for this and subsequent files;
  54.                 you're prompted for "BY?" and you should enter either
  55.                 "-x" or "x" or press Esc to get out of this: the archive
  56.                 is reread after you ask to re-sort it; x is one of:
  57.                         N = file name
  58.                         E = file extension
  59.                         D = file date and time
  60.                         S = file size of the original (non-compressed) file
  61.                         C = current (compressed) size of the file
  62.                         R = compression ratio
  63.                         O = original order (no sorting)
  64.         Esc     go to the next archive file (if any, else quit)
  65.         Quit    return to DOS (Ctrl-C also works)
  66.         Date    update the archive date
  67.  
  68. These options are presented on the right side of the screen and can be selected
  69. with the mouse cursor if one is available.
  70.  
  71. If the number of members in the archive exceeds 820, the program will continue
  72. to process the members but it will turn off the display of all information
  73. except for file names and will skip all sorting options.  If the number of
  74. members exceeds 1200, the program will skip all subsequent members although the
  75. information on last date and total bytes should still be accurate.
  76.  
  77.  
  78.  
  79. The AV.INI file:
  80.  
  81. AV will read a AV.INI file if one is found.  (You can specify a different file
  82. name if desired.) The file is an ASCII text file that can be created maintained
  83. by hand.  The file can consist or one or more command line parameters (only
  84. those that begin with a "/"), one statement per line.
  85.  
  86. The file can also contain comments which are blank lines or any line beginning
  87. with:
  88.         ;    (semi-colon)
  89.         :    (colon)
  90.         '    (quote)
  91.  
  92. AV looks for the initialization file in your default subdirectory first.  It
  93. then searches for it in the subdirectory where the executable was and then goes
  94. through your DOS path.
  95.  
  96. Passing in "/-I" or "/INULL" skips loading the INI file.  This saves some
  97. execution time as the program does not need to search your path for the file.
  98.  
  99.  
  100. CONFIGWS.EXE:
  101.  
  102. In addition to using the AV.INI file, you can permanently change some defaults
  103. within AV.EXE by using the CONFIGWS.EXE program.  CONFIGWS.EXE is not included
  104. in the AV distribution package but previous versions can typically be used with
  105. AV if desired.  (The same CONFIGWS.EXE program can be used to path a number of
  106. Wayne Software programs.) If CONFIGWS can't patch the executable, it will notify
  107. you of this before altering anything.
  108.  
  109. CONFIGWS.EXE allows you to set the following defaults:
  110.  
  111.         Pause output:   /P or /-P
  112.         List order:     /ON, /O-N, /OS, /O-S, /OD, /O-D, /OE, /O-E, /OC, /O-C
  113.  
  114. When setting options, the program will process defaults in the following order:
  115.   (1) CONFIGWS.EXE-settable settings
  116.   (2) AV.INI settings
  117.   (3) command-line settings
  118.  
  119. The *last* settings encountered win.
  120.  
  121.  
  122.  
  123. Syntax:
  124.  
  125.     AV filespec [ /-P | /P ] [ /Ox | /O-x ] [ /DATE ] [ /Iinitfile | /-I ]
  126.       [ /MOUSE | /-MOUSE ] [ /Q ] [ /? ] [ > filename ]
  127.  
  128. where:
  129.  
  130. "filespec" is the file specification to process.  Can include drive, path, and
  131. wildcards if desired.
  132.  
  133. "/P" says to view the directory in page mode.  This is the default but you can
  134. change this setting using the program CONFIGWS.EXE.  The default is
  135. automatically /-P (which can't be overridden) if redirection ("AV ... >
  136. filename") is used.
  137.  
  138. "/-P" says to view the directory not in page mode.  This prevents you from being
  139. offered the fix-date option as well.  This mode is automatic if redirection ("AV
  140. ... > filename") is used.
  141.  
  142. "/Ox" and "/O-x" allow you to specify the display order for the files.  "x" can
  143. be one of the following:
  144.  
  145.         N = file name
  146.         E = file extension
  147.         D = file date and time
  148.         S = file size of the original (non-compressed) file
  149.         C = current (compressed) size of the file
  150.         R = compression ratio
  151.         O = original order (no sorting)
  152.  
  153. If you precede the "x" with a dash ("-"), the sort will be done in reverse
  154. order.  Defaults to /OO but this can be altered using CONFIGWS.EXE.
  155.  
  156. "/DATE" resets the file date to that of the most recent member.  Automatically
  157. invokes /-P.  The command "AV *.* /DATE /Q" is a quick way to reset the file
  158. date stamps for all archives in your current subdirectory.
  159.  
  160. "/Iinitfile" says to read an initialization file with the file name "initfile".
  161. The file specification *must* contain a period.  If no drive or path information
  162. is specified, the program will search for initfile beginning in your default
  163. subdirectory and then going throughout your DOS path.  The use of an
  164. initialization file is optional.  Initially defaults to "/IAV.INI".
  165.  
  166. "/-I" (or "/INULL") says to skip loading the initialization file.
  167.  
  168. "/MOUSE" says to activate the mouse if present.  This is initially the default.
  169.  
  170. "/-MOUSE" says to skip activating the mouse even if present.
  171.  
  172. "/Q" skips the display of the member names.  Automatically invokes /DATE and /-P
  173. and is typically used in cases where you want to reset all file dates (e.g. "AV
  174. *.* /Q").
  175.  
  176. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  177.  
  178.  
  179. ">filename" redirects the output to a text file.  This automatically invokes
  180. the /-P option.  This is useful for getting a complete listing of the
  181. contents of your compressed files.  For example:
  182.  
  183.         AV *.* > TEMP.TXT
  184.  
  185.  
  186. Return codes:
  187.  
  188. AV returns the following ERRORLEVEL codes:
  189.         0 = no problems
  190.       254 = no valid archives were found
  191.       255 = syntax problems, file not found, or /? requested
  192.  
  193.  
  194. Author:
  195.  
  196. This program was written by Bruce Guthrie of Wayne Software.  It is free for use
  197. and redistribution provided relevant documentation is kept with the program, no
  198. changes are made to the program or documentation, and it is not bundled with
  199. commercial programs or charged for separately.  People who need to bundle it in
  200. for-sale packages must pay a $50 registration fee to "Wayne Software" at the
  201. following address.
  202.  
  203. Additional information about this and other Wayne Software programs can be found
  204. in the file BRUCEymm.DOC which should be included in the original ZIP file.
  205. ("ymm" is replaced by the last digit of the year and the two digit month of the
  206. release.  BRUCE312.DOC came out in December 1993.  This same naming convention
  207. is used in naming the ZIP file that this program was included in.) Comments and
  208. suggestions can also be sent to:
  209.  
  210.  
  211.                 Bruce Guthrie
  212.                 Wayne Software
  213.                 113 Sheffield St.
  214.                 Silver Spring, MD 20910
  215.  
  216.                 fax: (301) 588-8986
  217.  
  218. See BRUCEymm.DOC file for additional contact information.
  219.  
  220. Foreign users:  Please provide an Internet e-mail address in all correspondence.
  221.  
  222.